home *** CD-ROM | disk | FTP | other *** search
/ Atari Forever 4 / Atari Forever 4.zip / Atari Forever 4.iso / PD_THEMA / HARDDISK / HDSCAN16 / MENU.TRB < prev    next >
Text File  |  1998-03-14  |  6KB  |  266 lines
  1. /* This is the POPUP tree for HDSCAN release 1.6/2.6's README. */
  2. /* To view this in a more logical fashion, run the README program. */
  3. #:0
  4. X:20
  5. Y:2
  6. T:    POPHELP By Todd Burkey
  7. T:
  8. T:Uh-oh. You need HELP for POPHELP?
  9. T:OK, the first thing to remember is
  10. T:that in POPHELP, you really only
  11. T:need to use the four arrow keys
  12. T:and the ESC key. The up and down
  13. T:arrows will move you up and down in
  14. T:the current pop-up...but only when
  15. T:there is selectable (blue) text in
  16. T:the popup. Note that this popup has
  17. T:NO selectable text...you can just
  18. T:read it and exit. Which brings us
  19. T:to the left and right arrow keys.
  20. T:The right key gets you into a menu,
  21. T:while the left key moves you back
  22. T:out of a menu. The ESC key? It gets
  23. T:you out of the popups altogether.
  24. T:You can press the LEFT ARROW now.
  25.  
  26. #:1
  27. X:10
  28. Y:12
  29. T: NEW HDSCAN INFO  
  30. +:How to install  ->
  31. =:10
  32. +:Popups for help ->
  33. =:2
  34. +:Program invokes ->
  35. =:3
  36. +:Some bugs fixed ->
  37. =:4
  38. +:Extra documents ->
  39. =:5
  40. +:Future plans    ->
  41. =:6
  42. +:Program Limits  ->
  43. =:7
  44.  
  45. #:10
  46. X:15
  47. Y:12
  48. T:HDSCAN is very simple to install. Just copy
  49. T:HDSCAN26.PRG, HDSCAN.KEY, and HDSCAN.MNU to
  50. T:your favorite spot for utilities on your HD
  51. T:and you are all set.  Note that HDSCAN.MNU
  52. T:must be present if you want on-line help,
  53. T:and HDSCAN.KEY is necessary if you wish to
  54. T:redefine the command invoke keys and some of
  55. T:the program options.
  56.  
  57. #:2
  58. X:15
  59. Y:14
  60. T:Popup help was added to HDSCAN to clean up the HELP
  61. T:option and also pave the way for extended help and
  62. T:menu selection routines. This mechanism also allows
  63. T:the user to add their own help, since the help file
  64. T:is external to the program code.
  65. +:Help on POPHELP ->
  66. =:20
  67.  
  68. #:3
  69. X:20
  70. Y:14
  71. T:I finally got around to cleaning up program invokes.
  72. T:HDSCAN should now be able to run more of that pesky
  73. T:GEM code. If you use the 'immediate invoke' (# key)
  74. T:option, HDSCAN pretends you were in the directory the
  75. T:program was in when it invokes it. This allows .RSC
  76. T:files to be found correctly. Also, the '# key' invoke
  77. T:should reset the mouse state correctly and will turn
  78. T:off mouse->arrow key mappings.
  79.  
  80. #:4
  81. X:20
  82. Y:14
  83. T:I only found 1 bug in HDSCAN 2.5. When viewing files, I
  84. T:would open them via: ifp=fopen(fromstr,op) and for some
  85. T:strange reason, I was closing them via: fclose(fromstr).
  86. T:Now, why this always worked ok for me I'll never know.
  87.  
  88. #:5
  89. X:30
  90. Y:12
  91. T:The updated documenatation is in HDSCAN26.DOC.
  92. T:Sorry, but my printed manuals alway run behind
  93. T:my updates to HDSCAN.  I hope that with README
  94. T:and the on disk documents I have covered most
  95. T:of the new features.
  96.  
  97. #:6
  98. X:20
  99. Y:8
  100. T:HDSCAN 'hope'-list...subject to change
  101. T:--------------------------------------
  102. T: 1) Bug fixes - Ongoing
  103. T: 2) POPUP Menu Selection - Version 2.7
  104. T: 3) Sector & File Binary Editor - ????
  105. T: 4) Integrated 68000 Disassembler -???
  106. T: 5) Improved user interface - Ongoing
  107.  
  108. #:7
  109. X:25
  110. Y:11
  111. T:Current Program Limitations
  112. T:---------------------------
  113. T: 1) # files scanned  = 5000
  114. T: 2) # of directories = 300
  115. T: 3) Directory Depth  = 16
  116. T: 
  117. T:Note: HDSCAN's a memory hog
  118. T:  so 512K owners may not be
  119. T:  able to invoke other big
  120. T:  programs within HDSCAN.
  121.  
  122. /* Real help for POPHELP */
  123. #:20
  124. X:12
  125. Y:8
  126. T:GETTING STARTED
  127. +:Moving Around  
  128. =:22
  129. +:Some Comments  
  130. =:23
  131. +:Technical Info 
  132. =:26
  133.  
  134. #:26
  135. X:30
  136. Y:10
  137. +:MENU.TRB Format
  138. =:27
  139. +:COLOR Tables   
  140. =:28
  141.  
  142. #:27
  143. X:3
  144. Y:4
  145. T:The file MENU.TRB is processed by POPHELP's build_menu routine and
  146. T:drives the entire menu structure of POPHELP. The format of MENU.TRB
  147. T:is very simple. For example, the following is a sample 2 level menu
  148. T:with comments (note the comments can't really be part of the line):
  149. T:#:1             <-we are defining menu # 1
  150. T:X:10            <-the popup box will start at cursor column 10
  151. T:Y:4             <-and at cursor row number 4
  152. T:T:WELCOME       <-just some text to put in red (color #1)
  153. T:+:More Help     <-text for another menu selection
  154. T:=:2             <-go to menu 2 when the above text is selected
  155. T:#:2             <-all done with menu 1, so lets define menu 2 now
  156. T:X:5             <-new coordinates
  157. T:Y:6             <-new coordinates
  158. T:1:070           <-redefine color 1 (the text) to be green (RGB)
  159. T:<:afile.txt     <-menu 2 popup text is read from a file 
  160.  
  161. #:60
  162. X:20
  163. Y:8
  164. 1:530
  165. 2:053
  166. T:For RGB users only 
  167. T:  You were warned  
  168. +:Some soft colors   
  169. =:61
  170. +:Some Putrid ones   
  171. =:62
  172. +:Late night colors  
  173. =:63
  174.  
  175. #:61
  176. X:5
  177. Y:3
  178. 0:054
  179. 1:410
  180. 2:046
  181. 3:222
  182. T:Pastels?
  183. T:0:054
  184. T:1:500
  185. T:2:066
  186. T:3:333
  187.  
  188. #:62
  189. X:5
  190. Y:3
  191. 0:070
  192. 1:770
  193. 2:077
  194. 3:707
  195. T:Putrid
  196. T:0:070
  197. T:1:770
  198. T:2:077
  199. T:3:707
  200.  
  201. #:63
  202. X:5
  203. Y:3
  204. 0:000
  205. 1:700
  206. 2:007
  207. 3:770
  208. T:Brighter
  209. T:0:000
  210. T:1:700
  211. T:2:007
  212. T:3:770
  213.  
  214. #:28
  215. X:2
  216. Y:4
  217. T:Colors can be changed from the default setup dynamically within the menus,
  218. T:but extreme care should be taken so you don't screw things up for people
  219. T:who use monochrome monitors. The technique is quite simple. Within the
  220. T:MENU.TRB file, include the following fields when you want a new color:
  221. T:0:006          <--change color 0 to light blue (normal background)
  222. T:1:600          <--change color 1 to red (non-selectable text)
  223. T:2:000          <--change color 2 to black (for the shadow)
  224. T:3:775          <--change color 3 to off white (popup background).
  225. T:Note that the default color can be over-ridden by specifying a new color
  226. T:for menu # 1 (the first popup that is displayed by POPHELP).
  227. +:Some sample colors maps.
  228. =:60
  229.  
  230. #:22
  231. X:14
  232. Y:10
  233. +:ARROW KEYS 
  234. =:24
  235. +:HOW TO QUIT
  236. =:25
  237.  
  238. #:25
  239. X:40
  240. Y:12
  241. T:1) Press the ESC key. This takes
  242. T:   out of the help selection.
  243. T:2) Press the Q key. This exits  
  244. T:   you from the demo.
  245.  
  246. #:24
  247. X:30
  248. Y:12
  249. T:RIGHT ARROW = Select the hilited menu  
  250. T:LEFT ARROW  = Move to menu we came from
  251. T:UP ARROW    = Move up in the menu list 
  252. T:DOWN ARROW  = Move down in the list    
  253.  
  254. #:23
  255. X:15
  256. Y:11
  257. T:POPHELP is a simple, but clean, mechanism
  258. T:for both externalized and internally held
  259. T:help information. It was written only for
  260. T:fun, but may prove useful in standardized
  261. T:help utilities as its' features are tuned
  262. T:up and refined.  Any comments from anyone
  263. T:out there? Or is this idea just too wierd
  264. T:and far-fetched.
  265.  
  266.